package com.micro.ai.files.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.micro.ai.files.entity.FileUploadRecord;

/**
 * 文件上传记录服务接口
 * 
 * @author micro-ai
 * @since 0.0.1
 */
public interface FileUploadRecordService extends IService<FileUploadRecord> {

    /**
     * 创建上传记录
     */
    FileUploadRecord create(FileUploadRecord record);

    /**
     * 更新上传记录
     */
    FileUploadRecord update(String id, FileUploadRecord record);

    /**
     * 删除上传记录
     */
    void delete(String id);

    /**
     * 根据上传ID查询
     */
    FileUploadRecord getByUploadId(String uploadId);

    /**
     * 更新上传进度
     */
    void updateProgress(String uploadId, int uploadedChunks);

    /**
     * 完成上传
     */
    void completeUpload(String uploadId);

    /**
     * 取消上传
     */
    void cancelUpload(String uploadId);

    /**
     * 分页查询
     */
    Page<FileUploadRecord> pageQuery(int pageNum, int pageSize, String tenantId, 
                                     String keyword, String status);
}

